v9.1.7

Compare Source

v9.1.6

Compare Source

v9.1.5

Compare Source

v9.1.4

Compare Source

v9.1.3

Compare Source

• fix: better handle space in PATH

v9.1.2

Compare Source

v9.1.1

Compare Source

v9.1.0

Compare Source

Super saiyan god dog! It's over 9.0.0!

There's a bug with this release which prevents the deprecation notice to appear and requires to remove #!/usr/bin/env sh and . "$(dirname -- "$0")/_/husky.sh" (which are deprecated by the way). I'll publish a new version to fix that. Sorry about any inconvenience.

What's new

You can now run package commands directly, no need for npx or equivalents.
It makes writing hooks more intuitive and is also slightly faster 🐺⚡️

### .husky/pre-commit
- npx jest
+ jest # ~0.2s faster

A new recipe has been added to the docs. Lint staged files without external dependencies (inspired by Prettier docs). Feel free to modify it.

### .husky/pre-commit
prettier $(git diff --cached --name-only --diff-filter=ACMR | sed 's| |\\ |g') --write --ignore-unknown
git update-index --again

For more advanced use cases, see lint-staged.

Fixes

• bunx husky init command
• Workaround for some hooks implementation on Windows 🤷

Deprecations

• Remove #!/usr/bin/env sh and . "$(dirname -- "$0")/_/husky.sh" from your hooks
• Move your code from ~/.huskyrc to .config/husky/init.sh

Support for these will be removed in v10, notices have been added.

Friendly reminder

If Git hooks don't fit your workflow, you can disable Husky globally. Just add export HUSKY=0 to .config/husky/init.sh.

I've seen some confusion about this on X, so just a heads-up!

Sponsoring

Husky is downloaded over 45M times per month and used by ~1.5M projects. If your company wants to sponsor, you can do so here: GitHub Sponsors.

Have a nice summer ☀️ I'm open to new opportunities/consulting so feel free to drop me a message 😉

v9.0.11

Compare Source

• chore: update package-lock.json by @​btea in https://github.com/typicode/husky/pull/1383
• fix: husky=0 in init (fixes #​1393) by @​typicode in https://github.com/typicode/husky/pull/1395

v9.0.10

Compare Source

• fix: rename index.d.ts to index.d.mts by @​mrkjdy in https://github.com/typicode/husky/pull/1379

v9.0.9

Compare Source

• refactor: rename files by @​typicode in https://github.com/typicode/husky/pull/1378

v9.0.8

Compare Source

• docs: update index.md by @​khaledYS in https://github.com/typicode/husky/pull/1369
• Fix tab detection on install command by @​glensc in https://github.com/typicode/husky/pull/1376
• refactor: reduce file size by @​typicode in https://github.com/typicode/husky/pull/1377

v9.0.7

Compare Source

• fix: typo and source ~/.huskyrc correctly (compatibility with v8)
• docs: fix example by @​typicode in https://github.com/typicode/husky/pull/1363

v9.0.6

Compare Source

• docs: add favicon by @​rakleed in https://github.com/typicode/husky/pull/1354
• chore: apply editorconfig to code only by @​typicode in https://github.com/typicode/husky/pull/1355
• docs: update install script to mjs and fix CI checks by @​starnayuta in https://github.com/typicode/husky/pull/1357
• Fix unbound variable by @​typicode in https://github.com/typicode/husky/pull/1359

v9.0.5

Compare Source

• docs: update path to startup files by @​ManuelRauber in https://github.com/typicode/husky/pull/1350
• fix: init error by @​typicode in https://github.com/typicode/husky/pull/1353

v9.0.4

Compare Source

• fix: init create dir before by @​typicode in https://github.com/typicode/husky/pull/1348
• refactor: simplify by @​typicode in https://github.com/typicode/husky/pull/1349
• fix: init not working on pnpm #​1334 by @​rozbo in https://github.com/typicode/husky/pull/1347

v9.0.3

Compare Source

• docs: fix link by @​typicode in https://github.com/typicode/husky/pull/1340
• chore: fix links in issue template by @​julien-f in https://github.com/typicode/husky/pull/1341
• fix: add scripts field if not present by @​chalkygames123 in https://github.com/typicode/husky/pull/1338
• docs: changelog link by @​typicode in https://github.com/typicode/husky/pull/1343
• fix: insert final newline by @​chalkygames123 in https://github.com/typicode/husky/pull/1339
• fix: fix git hooks path on windows by @​rozbo in https://github.com/typicode/husky/pull/1346

v9.0.2

Compare Source

What's Changed

• fix: exit code by @​gergelypap in https://github.com/typicode/husky/pull/1336
• docs: typo by @​chalkygames123 in https://github.com/typicode/husky/pull/1337

New Contributors

• @​gergelypap made their first contribution in https://github.com/typicode/husky/pull/1336

Full Changelog: typicode/husky@v9.0.1...v9.0.2

v9.0.1

Compare Source

Kicking off the year with an exciting update!

TLDR;

Improved user experience and a (even) smaller package size while packing in more features!

👋 By the Way

I'm available for remote work (Front-end/Back-end mainly JS/TS but open to other stacks Rails, Go, Elixir). You can contact me at my mail: typicode at gmail 🙂

Introducing husky init

Adding husky to a project is now easier than ever. Although the installation process was straightforward, it often required consulting the documentation.

v8

npm pkg set scripts.prepare="husky install"
npm run prepare
npx husky add .husky/pre-commit "npm test"

v9

npx husky init

Adding a New Hook

Adding a hook is now as simple as creating a file. This can be accomplished using your favorite editor, a script or a basic echo command.

v8

npx husky add  .husky/pre-commit "npm test"
git add --chmod=+x .husky/pre-commit # On Windows

v9

echo "npm test" > .husky/pre-commit

Further Size Reduction

v8 was already the most compact Git hooks manager at approximately 6kB.

v9 takes this a step further, reducing the size to just 3kB, likely making it the smallest devDependency in your toolkit.

To give you an idea of how small it is, the biggest file in the project is the MIT license 😄

More to Come

Additional features are in the pipeline for v9. Stay tuned 🙌

Other Changes

• Enhanced security with CI and npm --provenance for safer publishing.
• Added $XDG_CONFIG_HOME support. Move ~/.huskyrc to ~/.config/husky/init.sh for centralized configuration.
• Fixed permission issue for Windows-created hooks; they no longer need to be executable.
• Removed husky install. Use husky or husky some/dir for the same functionality (deprecation notice to be added).
• Modified behavior when .git is missing; it now triggers a warning instead of failure.
• Replaced HUSKY_DEBUG=1 with HUSKY=2 for debugging.
• Updated the Husky API for module usage.
• Transitioned to ESM for module usage.
• Dropped support for Node 14 and 16.
• Revamped docs.

How to Migrate

v9 is backward compatible with v8, allowing you to freely upgrade and migrate your hooks later.

package.json

{
  "scripts": {
-   "prepare": "husky install"
+   "prepare": "husky"
  }
}

.husky/pre-commit

- #!/usr/bin/env sh
- . "$(dirname -- "$0")/_/husky.sh"
npm test

v8.0.3

Compare Source

• fix: add git not installed message #​1208

v8.0.2

Compare Source

• docs: remove deprecated npm set-script

v8.0.1

Compare Source

• fix: use POSIX equality operator

v8.0.0

Compare Source

What's Changed

Feats

• feat: add husky - prefix to logged global error messages by @​joshbalfour in https://github.com/typicode/husky/pull/1092
• feat: show PATH when command not found to improve debuggability
• feat: drop Node 12 support
• feat: skip install if $HUSKY=0

Fixes

• fix: hook script use /usr/bin/env sh instead of direct path of sh by @​skhaz in https://github.com/typicode/husky/pull/1051
• fix: actually set 'husky_skip_init' as readonly in ./husky.sh by @​hyperupcall in https://github.com/typicode/husky/pull/1104
• fix: force basename/dirname to treat $0 as an argument by @​mataha in https://github.com/typicode/husky/pull/1132
• fix: remove git.io links by @​renbaoshuo in https://github.com/typicode/husky/pull/1136

Docs

• docs: fix uninstall via npm by @​pddpd in https://github.com/typicode/husky/pull/1033
• docs: add dog emoji as favicon by @​jamiehaywood in https://github.com/typicode/husky/pull/1095
• docs: replace deprecated npx --no-install option with npx --no by @​sibiraj-s in https://github.com/typicode/husky/pull/1070
• docs: add pnpm installation by @​MohamadKh75 in https://github.com/typicode/husky/pull/1139

Chore

• chore: update workflows by @​tiziodcaio in https://github.com/typicode/husky/pull/1125

v7.0.4

Compare Source

No changes. Husky v7.0.3 was reverted, this version is the same as v7.0.2.

v7.0.3

Compare Source

v7.0.2

Compare Source

Fix pre-commit hook in WebStorm (#​1023)

v7.0.1

Compare Source

• Fix gracefully fail if Git command is not found #​1003 (same as in v6)

v7.0.0

Compare Source

• Improve .husky/ directory structure. .husky/.gitignore is now unnecessary and can be removed.
• Improve error output (shorter)
• Update husky-init CLI
• Update husky-4-to-7 CLI
• Drop Node 10 support

Please help me develop and release OSS projects ❤️ on GitHub Sponsors or Open Collective. Thank you for your support!

v6.0.0

Compare Source

After being in early access for Open Source projects and Sponsors for a limited time, I'm happy to announce that husky 6 is MIT again and can be freely used in commercial projects! 🎉

Many thanks to the Open Source projects and Companies which have switched to/sponsored the new husky during this period!

OSS is my full-time job, please consider sponsoring the development of husky on GitHub sponsors or Open Collective. Thank you!

Breaking change

• husky init has been moved to its own package (npx husky-init)

Added

• Programmatically use husky: require('husky')
• TypeScript definitions

Migrating from husky 4

Husky 6 contains breaking changes. If you're coming from v4, npm install husky@6 won't be enough.

Recommended: see husky-4-to-6 CLI to automatically migrate your config. There's also a dedicated section in the docs.

If you're curious why config has changed, you may be interested in reading:
https://blog.typicode.com/husky-git-hooks-javascript-config/

Also Husky 6 follows official npm and Yarn best practices regarding autoinstall. It's recommended to use prepare script instead (see usage in docs).

v5.2.0

Compare Source

• Add set command to replace hooks (husky set .husky/pre-commit cmd)
• Update add command to append command (husky add .husky/pre-commit cmd)
• Improve error messages